<!DOCTYPE html>


















































<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

  <meta name="description" content="Javadoc API documentation for org.eclipse.sisu.inject." />

<!-- <link rel="shortcut icon" type="image/x-icon" href="./favicon.ico" /> -->
<title>

  Package Index


| org.eclipse.sisu.inject

</title>
<link href="./../assets/doclava-developer-docs.css" rel="stylesheet" type="text/css" />
<link href="./../assets/customizations.css" rel="stylesheet" type="text/css" />
<script src="./../assets/search_autocomplete.js" type="text/javascript"></script>
<script src="./../assets/jquery-resizable.min.js" type="text/javascript"></script>
<script src="./../assets/doclava-developer-docs.js" type="text/javascript"></script>
<script src="./../assets/prettify.js" type="text/javascript"></script>
<script type="text/javascript">
  setToRoot("./", "./../assets/");
</script>
<script src="./../assets/doclava-developer-reference.js" type="text/javascript"></script>
<script src="./../assets/navtree_data.js" type="text/javascript"></script>
<script src="./../assets/customizations.js" type="text/javascript"></script>
<noscript>
  <style type="text/css">
    html,body{overflow:auto;}
    #body-content{position:relative; top:0;}
    #doc-content{overflow:visible;border-left:3px solid #666;}
    #side-nav{padding:0;}
    #side-nav .toggle-list ul {display:block;}
    #resize-packages-nav{border-bottom:3px solid #666;}
  </style>
</noscript>
</head>

<body class="gc-documentation">

<div id="header">
    <div id="headerLeft">
    
      <span id="masthead-title">org.eclipse.sisu.inject</span>
    
    </div>
    <div id="headerRight">
      
  <div id="search" >
      <div id="searchForm">
          <form accept-charset="utf-8" class="gsc-search-box" 
                onsubmit="return submit_search()">
            <table class="gsc-search-box" cellpadding="0" cellspacing="0"><tbody>
                <tr>
                  <td class="gsc-input">
                    <input id="search_autocomplete" class="gsc-input" type="text" size="33" autocomplete="off"
                      title="search developer docs" name="q"
                      value="search developer docs"
                      onFocus="search_focus_changed(this, true)"
                      onBlur="search_focus_changed(this, false)"
                      onkeydown="return search_changed(event, true, './')"
                      onkeyup="return search_changed(event, false, './')" />
                  <div id="search_filtered_div" class="no-display">
                      <table id="search_filtered" cellspacing=0>
                      </table>
                  </div>
                  </td>
                  <td class="gsc-search-button">
                    <input type="submit" value="Search" title="search" id="search-button" class="gsc-search-button" />
                  </td>
                  <td class="gsc-clear-button">
                    <div title="clear results" class="gsc-clear-button">&nbsp;</div>
                  </td>
                </tr></tbody>
              </table>
          </form>
      </div><!-- searchForm -->
  </div><!-- search -->
      
    </div>
</div><!-- header -->


  <div class="g-section g-tpl-240" id="body-content">
    <div class="g-unit g-first side-nav-resizable" id="side-nav">
      <div id="swapper">
        <div id="nav-panels">
          <div id="resize-packages-nav">
            <div id="packages-nav">
              <div id="index-links">
                <a href="./packages.html" class="selected" >Package Index</a> | 
                <a href="./classes.html" >Class Index</a>
              </div>
              <ul>
                
    <li class="api apilevel-">
  <a href="./org/eclipse/sisu/package-summary.html">org.eclipse.sisu</a></li>
    <li class="api apilevel-">
  <a href="./org/eclipse/sisu/bean/package-summary.html">org.eclipse.sisu.bean</a></li>
    <li class="api apilevel-">
  <a href="./org/eclipse/sisu/inject/package-summary.html">org.eclipse.sisu.inject</a></li>
    <li class="api apilevel-">
  <a href="./org/eclipse/sisu/launch/package-summary.html">org.eclipse.sisu.launch</a></li>
    <li class="api apilevel-">
  <a href="./org/eclipse/sisu/osgi/package-summary.html">org.eclipse.sisu.osgi</a></li>
    <li class="api apilevel-">
  <a href="./org/eclipse/sisu/space/package-summary.html">org.eclipse.sisu.space</a></li>
    <li class="api apilevel-">
  <a href="./org/eclipse/sisu/wire/package-summary.html">org.eclipse.sisu.wire</a></li>
    <li class="api apilevel-">
  <a href="./org/sonatype/inject/package-summary.html">org.sonatype.inject</a></li>
              </ul><br/>
            </div> <!-- end packages -->
          </div> <!-- end resize-packages -->
          <div id="classes-nav">
              <script>
                /*addLoadEvent(maxPackageHeight);*/
              </script>
              <p style="padding:10px">Select a package to view its members</p><br/>
          </div><!-- end classes -->
        </div><!-- end nav-panels -->
        <div id="nav-tree" style="display:none">
          <div id="index-links">
            <a href="./packages.html" class="selected" >Package Index</a> | 
            <a href="./classes.html" >Class Index</a>
          </div>
        </div><!-- end nav-tree -->
      </div><!-- end swapper -->
    </div> <!-- end side-nav -->
    <script>
      if (!isMobile) {
        <!-- $("<a href='#' id='nav-swap' onclick='swapNav();return false;' style='font-size:10px;line-height:9px;margin-left:1em;text-decoration:none;'><span id='tree-link'>Use Tree Navigation</span><span id='panel-link' style='display:none'>Use Panel Navigation</span></a>").appendTo("#side-nav"); -->
        chooseDefaultNav();
        if ($("#nav-tree").is(':visible')) {
          init_default_navtree("./");
        } else {
          addLoadEvent(function() {
            scrollIntoView("packages-nav");
            scrollIntoView("classes-nav");
          });
        }
        $("#swapper").css({borderBottom:"2px solid #aaa"});
      } else {
        swapNav(); // tree view should be used on mobile
      }
    </script>



<div class="g-unit" id="doc-content">

<div id="jd-header">
<h1>Package Index</h1>
</div>

<div id="jd-content">

<div class="jd-descr">
<h1>Overview</h1>
Sisu is a modular <a href="http://atinject.googlecode.com/svn/trunk/javadoc/javax/inject/package-summary.html">JSR330</a>-based container that supports classpath scanning, auto-binding, and dynamic auto-wiring.
<p><p>
Sisu uses <a href="http://code.google.com/p/google-guice/">Google-Guice</a> to perform dependency injection and provide the core JSR330 support, but removes the need to write explicit bindings in Guice modules:
<p><pre>
Guice.createInjector(
  new <code><a href="./org/eclipse/sisu/wire/package-summary.html">WireModule</a></code>(                       // auto-wires unresolved dependencies
    new <code><a href="./org/eclipse/sisu/space/package-summary.html">SpaceModule</a></code>(                     // scans and binds @Named components
      new <code><a href="./org/eclipse/sisu/space/package-summary.html">URLClassSpace</a></code>( classloader )    // abstracts class/resource finding
) ) );
</pre>
In the example above the <code>SpaceModule</code> scans the classpath using the <code>ClassSpace</code> abstraction. Any classes annotated with a <code>@Qualifier</code> annotation like <code>@Named</code>
will be bound as components, making them visible to the <code><a href="./org/eclipse/sisu/inject/package-summary.html">BeanLocator</a></code> and surrounding <code>WireModule</code> (constructed around the set of modules making up
the application; in this example there is only one, the <code>SpaceModule</code>).
<p><p>
The <code>WireModule</code> uses the Guice introspection SPI to analyze all bindings in the application and apply various rules to finish wiring the configuration. Unsatisfied <code>@Inject</code>
requirements are populated using the <code>BeanLocator</code> which provides a lookup service across all injectors it knows about, allowing for plugin-style solutions. As well as individual
components, the <code>WireModule</code> can satisfy requests for component collections like Lists and Maps (using <code>@Named</code> values as keys). It also cleans up duplicate and overridden
bindings, and merges <code><a href="./org/eclipse/sisu/Parameters.html">Parameters</a></code> bindings.
<h2>Packages</h2>
</div>


<table class="jd-sumtable">

    <tr class="alt-color api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/eclipse/sisu/package-summary.html">org.eclipse.sisu</a></td>
        <td class="jd-descrcol" width="100%">Injectable API for Sisu components (a.k.a beans).</td>
    </tr>


    <tr class=" api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/eclipse/sisu/bean/package-summary.html">org.eclipse.sisu.bean</a></td>
        <td class="jd-descrcol" width="100%">Customizable injection of bean properties, based on <a href="http://code.google.com/p/google-guice/wiki/CustomInjections">http://code.google.com/p/google-guice/wiki/CustomInjections</a>.</td>
    </tr>


    <tr class="alt-color api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/eclipse/sisu/inject/package-summary.html">org.eclipse.sisu.inject</a></td>
        <td class="jd-descrcol" width="100%">Dynamic bean lookup across multiple injectors.</td>
    </tr>


    <tr class=" api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/eclipse/sisu/launch/package-summary.html">org.eclipse.sisu.launch</a></td>
        <td class="jd-descrcol" width="100%">Utilities to test, launch, and extend Sisu applications.</td>
    </tr>


    <tr class="alt-color api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/eclipse/sisu/osgi/package-summary.html">org.eclipse.sisu.osgi</a></td>
        <td class="jd-descrcol" width="100%"></td>
    </tr>


    <tr class=" api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/eclipse/sisu/space/package-summary.html">org.eclipse.sisu.space</a></td>
        <td class="jd-descrcol" width="100%">Customizable scanning of bean implementations.</td>
    </tr>


    <tr class="alt-color api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/eclipse/sisu/wire/package-summary.html">org.eclipse.sisu.wire</a></td>
        <td class="jd-descrcol" width="100%">Customizable wiring of unresolved dependencies.</td>
    </tr>


    <tr class=" api apilevel-" >
        <td class="jd-linkcol">
  <a href="./org/sonatype/inject/package-summary.html">org.sonatype.inject</a></td>
        <td class="jd-descrcol" width="100%">Deprecated; new applications should use <code><a href="./org/eclipse/sisu/package-summary.html">org.eclipse.sisu</a></code>.</td>
    </tr>


</table>

<div id="footer">
Generated by <a href="http://code.google.com/p/doclava/">Doclava</a>.
</div> <!-- end footer -->

</div><!-- end jd-content -->
</div> <!-- end doc-content -->

</div> <!-- end body-content --> 

<script type="text/javascript">
init(); /* initialize doclava-developer-docs.js */
</script>

</body>
</html>
